home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 September / PCWorld_2008-09_cd.bin / multimedia / tuxpaint / tuxpaint-0.9.20-win32-installer.exe / {app} / docs / libdocs / fltk / README < prev   
Encoding:
Text File  |  2007-08-11  |  7.8 KB  |  214 lines
  1. README - Fast Light Tool Kit (FLTK) Version 1.1.4
  2. -------------------------------------------------
  3.  
  4. WHAT IS FLTK?
  5.  
  6.     The Fast Light Tool Kit ("FLTK", pronounced "fulltick") is a
  7.     a cross-platform C++ GUI toolkit for UNIX(r)/Linux(r) (X11),
  8.     Microsoft(r) Windows(r), and MacOS(r) X. FLTK provides
  9.     modern GUI functionality without the bloat and supports 3D
  10.     graphics via OpenGL(r) and its built-in GLUT emulation. It
  11.     was originally developed by Mr. Bill Spitzak and is
  12.     currently maintained by a small group of developers across
  13.     the world with a central repository in the US.
  14.  
  15.  
  16. LICENSING
  17.  
  18.     FLTK comes with complete free source code. FLTK is available
  19.     under the terms of the GNU Library General Public License.
  20.     Contrary to popular belief, it can be used in commercial
  21.     software! (Even Bill Gates could use it.) 
  22.  
  23.  
  24. ON-LINE DOCUMENTATION
  25.  
  26.     All of the documentation is in HTML in the subdirectory
  27.     "documentation". The "index.html" file should be your
  28.     starting point.  PostScript(tm) and PDF versions of this
  29.     documentation is also available from the FLTK web site at:
  30.  
  31.         http://www.fltk.org/documentation.php
  32.  
  33.  
  34. BUILDING AND INSTALLING FLTK UNDER UNIX AND MacOS X
  35.  
  36.     In most cases you can just type "make".  This will run
  37.     configure with the default (no) options and then compile
  38.     everything.
  39.  
  40.     FLTK uses GNU autoconf to configure itself for your UNIX
  41.     platform. The main things that the configure script will
  42.     look for are the X11, OpenGL (or Mesa), and JPEG header and
  43.     library files.  Make sure that they are in the standard
  44.     include/library locations.  If they aren't you need to
  45.     define the CFLAGS, CXXFLAGS, and LDFLAGS environment
  46.     variables.
  47.  
  48.     If you aren't using "gcc", "g++", "c++", or "CC" for your
  49.     C++ compiler, you'll also need to set the CXX environment
  50.     variable. Similarly, if you aren't using "gcc" or "cc" for
  51.     your C compiler you'll need to set the CC environment
  52.     variable.
  53.  
  54.     You can run configure yourself to get the exact setup you
  55.     need. Type "./configure <options>".  Options include:
  56.  
  57.     --enable-cygwin         - Enable the Cygwin libraries (WIN32)
  58.     --enable-debug          - Enable debugging code & symbols
  59.     --disable-gl            - Disable OpenGL support
  60.     --enable-shared         - Enable generation of shared libraries
  61.     --enable-threads        - Enable multithreading support
  62.     --enable-xdbe           - Enable the X double-buffer extension
  63.     --enable-xft            - Enable the Xft library (anti-aliased fonts)
  64.  
  65.     --bindir=/path          - Set the location for executables
  66.                               [default = /usr/local/bin]
  67.     --libdir=/path          - Set the location for libraries
  68.                               [default = /usr/local/lib]
  69.     --includedir=/path      - Set the location for include files.
  70.                               [default = /usr/local/include]
  71.     --prefix=/dir           - Set the directory prefix for files
  72.                               [default = /usr/local]
  73.  
  74.     When the configure script is done you can just run the
  75.     "make" command. This will build the library, FLUID tool, and
  76.     all of the test programs.
  77.  
  78.     To install the library, become root and type "make
  79.     install".  This will copy the "fluid" executable to
  80.     "bindir", the header files to "includedir", and the library
  81.     files to "libdir".
  82.  
  83.  
  84. BUILDING FLTK UNDER MICROSOFT WINDOWS
  85.  
  86.     There are two ways to build FLTK under Microsoft Windows. 
  87.     The first is to use the VC++ 6.0 project files under the
  88.     "visualc" directory.  Just open (or double-click on) the
  89.     "fltk.dsw" file to get the whole shebang.
  90.  
  91.     The second method is to use a GNU-based development tool
  92.     with the files in the "makefiles" directory.  To build
  93.     with the CygWin tools, use the supplied configure script
  94.     as specified in the UNIX section above:
  95.  
  96.         sh configure ...options...
  97.  
  98.     To build using other tools simply copy the appropriate
  99.     makeinclude and config files to the main directory and do a
  100.     make:
  101.  
  102.     copy makefiles\Makefile.<env> Makefile
  103.     make
  104.  
  105.  
  106. BUILDING FLTK UNDER OS/2
  107.  
  108.     The current OS/2 build requires XFree86 for OS/2 to work.  A
  109.     native Presentation Manager version has not been implemented
  110.     yet (volunteers are welcome!).
  111.  
  112.     To build the XFree86 version of FLTK for OS/2, copy the
  113.     appropriate makeinclude and config files to the main
  114.     directory and do a make:
  115.  
  116.         copy makefiles\Makefile.os2x Makefile
  117.     make
  118.  
  119.  
  120. INTERNET RESOURCES
  121.  
  122.     FLTK is available on the 'net in a bunch of locations:
  123.  
  124.     - WWW:   http://www.fltk.org
  125.              http://fltk.sourceforge.net
  126.  
  127.     - FTP:   ftp://ftp.easysw.com/pub/fltk
  128.                  ftp://ftp2.easysw.com/pub/fltk
  129.                  ftp://ftp.northamerica.net/pub/ESP/fltk
  130.              ftp://ftp.funet.fi/mirrors/ftp.easysw.com/pub/fltk
  131.  
  132.     - EMail: fltk@fltk.org [see instructions below]
  133.              fltk-bugs@fltk.org [for reporting bugs]
  134.  
  135.     To send a message to the FLTK mailing list ("fltk@fltk.org")
  136.     you must first join the list.  Non-member submissions are
  137.     blocked to avoid problems with SPAM.
  138.  
  139.     To join the FLTK mailing list, send a message to
  140.     "majordomo@fltk.org" with "subscribe fltk" in the message
  141.     body.  A digest of this list is available by subscribing to
  142.     the "fltk-digest" mailing list.
  143.  
  144.  
  145. REPORTING BUGS
  146.  
  147.     To report a bug in FLTK, send an email to
  148.     "fltk-bugs@fltk.org". Please include the FLTK version,
  149.     operating system & version, and compiler that you are using
  150.     when describing the bug or problem.  You can also submit a
  151.     bug on the SourceForge pages.
  152.  
  153.     For general support and questions, please use the FLTK
  154.     mailing list at "fltk@fltk.org".
  155.  
  156.  
  157. MESA
  158.  
  159.     Currently the best way to get OpenGL on your Linux system is
  160.     to use Mesa.  FLTK has been tested with Mesa on several
  161.     machines (and also with "real" OpenGL on SGI machines). Mesa
  162.     is available at:
  163.  
  164.         http://www.mesa3d.org
  165.  
  166.     The configure script will not see Mesa unless it is
  167.     installed as either libGL or libMesaGL.  If you don't want
  168.     to do this you will have to edit config.h (set HAVE_GL to 1)
  169.     and makeinclude (add the libraries).
  170.  
  171.  
  172. TRADEMARKS
  173.  
  174.     Microsoft and Windows are registered trademarks of Microsoft
  175.     Corporation. UNIX is a registered trademark of the X/Open
  176.     Group, Inc.  OpenGL is a registered trademark of Silicon
  177.     Graphics, Inc.  MacOS is a registered trademark of Apple
  178.     Computers, Inc.
  179.  
  180.  
  181. COPYRIGHT
  182.  
  183.     FLTK is copyright 1998-2003 by Bill Spitzak
  184.     (spitzak@users.sourceforge.net) and others, including:
  185.  
  186.         Craig P. Earls
  187.     Curtis Edwards (trilex@users.sourceforge.net)
  188.     Gustavo Hime (hime@users.sourceforge.net)
  189.     Talbot Hughes
  190.     Robert Kesterson (robertk@users.sourceforge.net)
  191.     Matthias Melcher (matthiaswm@users.sourceforge.net)
  192.     James Dean Palmer (jamespalmer@users.sourceforge.net)
  193.     Vincent Penne (vincentp@users.sourceforge.net)
  194.         Michael Sweet (easysw@users.sourceforge.net)
  195.     Carl Thompson (clip@users.sourceforge.net)
  196.     Nafees Bin Zafar (nafees@users.sourceforge.net)
  197.  
  198.     This library is free software; you can redistribute it
  199.     and/or modify it under the terms of the GNU Library General
  200.     Public License as published by the Free Software Foundation;
  201.     either version 2 of the License, or (at your option) any
  202.     later version.
  203.  
  204.     This library is distributed in the hope that it will be
  205.     useful, but WITHOUT ANY WARRANTY; without even the implied
  206.     warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  207.     PURPOSE.  See the GNU Library General Public License for
  208.     more details.
  209.  
  210.     You should have received a copy of the GNU Library General
  211.     Public License along with this library; if not, write to the
  212.     Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  213.     Boston, MA 02111-1307 USA.
  214.